home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / PRINTER / 2COL35.ARJ / 2COL.DOC next >
Text File  |  1992-07-25  |  22KB  |  578 lines
  1.                                  2col
  2.  
  3.                          Shareware Version 3.5
  4.  
  5.                       A Compressed Print Utility
  6.  
  7.                             Copyright 1992
  8.                                   by
  9.  
  10.                           ARCaine Technology
  11.                             960 Neilson St
  12.                            Albany, CA 94706
  13.                             (510) 527-9859
  14.  
  15.                           All Rights Reserved
  16.  
  17.  
  18.  
  19.  
  20. YE OLDE DISCLAIMER
  21.  
  22.   This software and manual are sold "as is" and without warranties
  23.   as to performance or merchantability or any other warranties
  24.   whether expressed or implied. Because of the various hardware and
  25.   software environments into which this program may be put, no
  26.   warranty of fitness for a particular purpose is offered. The user
  27.   must assume the entire risk of using and evaluating this program.
  28.   Any liability of the seller will be limited exclusively to product
  29.   replacement or refund of purchase price.
  30.  
  31.  
  32.  
  33. Introduction
  34.  
  35.   2col prints an ASCII text file in two columns,each up to 80
  36.   characters wide, on standard width paper. It eliminates
  37.   consecutive blank lines and prints at 20 characters/inch.
  38.  
  39.   2col is designed to be extremely easy to use. The default settings
  40.   will accommodate most printing needs. On most  9-pin printers
  41.   you can print a document by simply typing: 2COL [filename] <enter>
  42.   For example, to print this manual type:2COL 2COL.DOC <enter>
  43.   On 24-pin printers you must also include -Q on the command line.
  44.   To see a demonstration of 2COL's many print modes you can
  45.   type: DEMO2COL [9 or 24] <enter>
  46.  
  47.   2col is intended to greatly reduce the huge volume of paper that
  48.   results from printing reference manuals and text files. Regular
  49.   use of this program should cut your paper bill by 60 to 70
  50.   percent. It provides excellent readability (unlike other
  51.   compressed print programs) while compressing an average of
  52.   four pages of source material onto one side of a sheet of
  53.   paper. By using its even/odd alternate side print feature eight
  54.   pages of text can be printed using both sides of a page. Since the
  55.   normal draft mode of printing is used it is also much faster than
  56.   those programs which rely on nonstandard print modes.
  57.  
  58.   By reducing the volume of paper, 2col also reduces storage
  59.   requirements and the bulk one has to carry around when traveling.
  60.   It can also save you money when faxing or mailing documents.
  61.  
  62.   As a side benefit, many 2col users actually find it easier and
  63.   faster to read the compressed versions than the originals because
  64.   they can take in more words at one time without having to scan
  65.   across the page.
  66.  
  67.   2col will optionally print in subscript mode - doubling the amount
  68.   of text contained on a single sheet to a total of sixteen pages -
  69.   with a significant loss in legibility and printing speed. This
  70.   mode is intended mainly for archival use not for documents that
  71.   will be read frequently.
  72.  
  73.   This program will work on most Epson-compatible dot-matrix
  74.   printers which provide 17 characters/inch compressed printing but
  75.   is especially intended for newer printers which have a
  76.   compressed/elite mode (20 char/in) allowing two complete 80
  77.   character lines to be printed across the page. Printers which
  78.   support 20 char/inch include:KXP1180, KXP1124, FX86, 200GX,
  79.   LQ-series, etc. If you have a 17 char/inch printer see the
  80.   registration section below about obtaining a word-wrap utility.
  81.  
  82.   Since most printers do not show the 20 char/inch mode on the front
  83.   panel, you should check the manual or just try printing with 2col.
  84.   If your printer supports 20 char/in but does not operate properly
  85.   with 2col, contact me, and I will let you know if it is possible
  86.   to provide you with an updated version that is compatible with
  87.   your printer.
  88.  
  89.  
  90. IMPORTANT!
  91.  
  92.   The 20 char/in mode on many printers cannot be accessed by
  93.   software if the DIP switches inside the printer are set for IBM
  94.   mode. The printer MUST be set for the Epson/Standard mode. 2col
  95.   will optionally supply the control characters to cause the full
  96.   IBM character set to print. Also, your printer should have the
  97.   auto linefeed switch turned off. If your printer has a front panel
  98.   pitch control, it should be set to program mode. On most printers
  99.   it is okay to set a specific font from the front panel as long as
  100.   the pitch is left in program mode.
  101.  
  102.  
  103. Registration
  104.  
  105.   I will keep improving the program if I know enough people are
  106.   finding it useful.
  107.  
  108.   My registration policy is very flexible. The nominal fee is $20 US
  109.   If you don't feel you will get $20 worth of use out of 2COL, send
  110.   whatever it is worth to you. If you are impoverished and can't
  111.   afford to pay anything, enclose a stamped self-addressed envelope
  112.   and I will send you a registration.
  113.  
  114.   This is not freeware or public domain. Shareware is simply a means
  115.   of marketing commercial software. You are required to register if
  116.   you intend to use this program after a reasonable trial period.
  117.  
  118.   When registering, please tell me the version number you have, your
  119.   printer model, and where you obtained your copy of 2col.
  120.   Registration checks should be made payable to "Tony Caine".
  121.  
  122.   2col should be registered for the maximum number of copies that
  123.   can be used simultaneously at your site. Site fees for commercial
  124.   users can be negotiated.
  125.  
  126.   If you register for the full $20 fee and include a $3.95 Shipping
  127.   and Handling fee I will send you the latest versions of 2COL and
  128.   JETCOL (for lasers). JETCOL requires a separate registration fee
  129.   if you decide to use it after a trial period. I will also send a
  130.   shareware word wrap program (by another author) which can be used
  131.   to expand or contract the column width of documents before
  132.   printing. This is particularly useful for those with 17 char/inch
  133.   printers which cannot print two full 80 character columns. The
  134.   word wrap program requires a $10 registration fee if used past 30
  135.   days.
  136.  
  137.   ATTENTION CURRENTLY REGISTERED USERS:
  138.   The new customized default settings required that I change over to
  139.   individualized registration numbers. This means that currently
  140.   registered users will need to upgrade ($10 fee) to use this new
  141.   version.
  142.  
  143. Registered version features
  144.  
  145.  
  146.  
  147. * Custom default settings
  148.  
  149.    2COL's default settings can be modified by the user. This
  150.    eliminates the need for the user to enter a string of options
  151.    whenever they run the program. They need only enter the filename.
  152.  
  153.  
  154. * Automargin
  155.  
  156.    The automargin option is extremely useful for those who need to
  157.    punch holes for binding. 2col scans the entire document before
  158.    printing and, in effect, moves all the available "white space"
  159.    from the center (and, if necessary,from the right margin) of the
  160.    document to the left margin.
  161.  
  162.    To get an idea of how Automargin operates, type: 2COL 2COL.DOC
  163.    <enter>. This will print with the default settings of 2col. Then
  164.    type: 2COL 2COL.DOC -K -U8 <enter>. This will print a one page
  165.    demo using automargin.
  166.  
  167.  
  168. * Multiple document names
  169.  
  170.    Multiple document names and wildcards can be entered on the
  171.    command line.
  172.  
  173.  
  174. * Append
  175.  
  176.    When specifying multiple documents to print, registered users
  177.    have the choice of starting each file at the beginning of a page
  178.    or treating all documents as one continuous file without breaks.
  179.  
  180.  
  181. * Redirection of output
  182.  
  183.    Registered users can choose to send the output to a disk file for
  184.    later printing in background (while running other programs) or
  185.    they can send to LPT2, COM1, COM2, etc.
  186.  
  187.  
  188. * Pagefix
  189.  
  190.    Prints a specified number of pages per column retaining original
  191.    line spacing and page breaks.
  192.  
  193.  
  194. * The registration screen is eliminated, of course.
  195.  
  196.  
  197.  
  198. Terminology
  199.  
  200.   Since several pages from the original source file are combined
  201.   onto a single page of printer output, there may be some confusion
  202.   about the word "page." We will always refer to the original
  203.   document pages as "source pages." What is actually printed will
  204.   simply be called "pages."
  205.  
  206.  
  207.  
  208. Usage:
  209.  
  210.   2col  [options] path\filename [options] [path\filename]...
  211.  
  212.  
  213.   Options (except -Yx) may be specified in any order before and/or
  214.   after the file name(s). Options MUST be separated from each other
  215.   by spaces and preceded by a "-". Upper and lower case are
  216.   interchangeable.
  217.  
  218.  
  219.  
  220.  
  221.   Options are defined as follows:
  222.  
  223.    -Lxx = Each column will be xx lines long
  224.    -Cxx = No more than xx consecutive blank lines will be printed
  225.    -Sxx = Skip xx pages before starting to print
  226.    -O   = Print only odd # pages
  227.    -E   = Print only even # pages
  228.    -Wxx = column width (number of characters in each column)
  229.    -P   = Pause before printing each page.
  230.    -N   = Prints filename and page # at lower left corner
  231.    -D   = Delimit each (source) page with a line and page #
  232.    -T   = Truncate long lines instead of wrap.
  233.    -G   = Enable full IBM graphics set.
  234.    -Fx  = Put a margin of x blank lines at the top of each page.
  235.    -K   = Print a one page demo in registered mode.
  236.  * -Mx  = Set left margin.(CAUTION:READ INSTRUCTIONS BEFORE USING)*
  237.    -?   = 2COL will ask for filenames to print.
  238.    -Q   = 24-pin printer line spacing
  239.    ?    = (no dash) Prints help screen. Must be the only option.
  240.  
  241.                 *Options for registered users only*
  242.  
  243.    -A   = Append multiple files.
  244.    -Z   = Route output to disk.
  245.    -Ux  = Scans file before printing and sets margins automatically.
  246.    -Xx  = Print x pages/column preserving page breaks & format
  247.    -Yx  = Customize 2COL default settings.
  248.  
  249.  
  250.   When more than 102 lines/page requested,shifts to subscript
  251.   (half-height) mode. When column width is less than 69 chars,uses
  252.   compressed mode (17 char/in.) When column width is greater than
  253.   68 uses compressed/elite (20 char/in.)
  254.  
  255.   Defaults: 80 characters/column;88 lines/page;1 consecutive blank
  256.            line; no pause before printing page; do not number pages;
  257.            wrap (not truncate) long lines;0 blank lines at top of
  258.            page.
  259.  
  260.  
  261. Description of options
  262.  
  263.  
  264.    -Lxxx
  265.  
  266.       Each column will contain xxx lines of data. Line spacing will
  267.       be automatically adjusted to approximately fill the page.
  268.       Characters will be normal (pica) height until more than 102
  269.       lines/column are specified; printer will then shift to
  270.       subscript mode allowing up to 220 lines/column. Default value
  271.       is 88.
  272.  
  273.  
  274.     -Cxx
  275.  
  276.       Pages of text frequently contain many blank lines of data.
  277.       Experience has shown that most of these can be discarded
  278.       without sacrificing readability. This option specifies that
  279.       when there are more than xx consecutive blank lines, the
  280.       excess will be discarded. If you set xx=66, 2col will print
  281.       each page in its original format without discarding any blank
  282.       lines. The default value is 1.
  283.  
  284.  
  285.     -Sxx
  286.  
  287.       This feature is useful if you have a paper jam or decide to
  288.       print part now and part later. Using this option will cause xx
  289.       pages to be skipped before printing begins. For example,
  290.       specifying "-S2" will cause printing to begin with page 3.
  291.  
  292.  
  293.     -O
  294.  
  295.       This and the -E option allow you to print on both sides of
  296.       each sheet of paper. By specifying "-O", only the odd numbered
  297.       pages will be printed. When printing is complete,reload the
  298.       first page back into the printer with the blank side facing
  299.       the print head and rerun 2col using the -E option.
  300.  
  301.       Alternatively, 2COL will ask you whether you want to print the
  302.       even pages after it has finished printing the odd. Respond "Y"
  303.       after the paper has been reloaded or type "X" to terminate.
  304.  
  305.     -E
  306.  
  307.       Prints only even numbered pages. When using this option after
  308.       the -O option be sure to shift the paper about 1/2 inch to the
  309.       right before starting to print, to allow space for hole
  310.       punching or other binding requirements.
  311.  
  312.  
  313.     -Wxx
  314.  
  315.       This option specifies how wide each column will be. Wrapping
  316.       or truncating will begin at this position. It also determines
  317.       the print density. If xx is 68 or less, the printer will use
  318.       compressed mode (137 characters across the page). If xx is 69
  319.       or larger the printer will use compressed/elite (160
  320.       characters/line). If your printer does not support
  321.       compressed/elite and you try to use it, you will end up with a
  322.       mess. You should then specify xx as 68 and decide whether you
  323.       want to truncate long lines or wrap them. Since 2COL wraps
  324.       in mid-word you might want to obtain a shareware word wrapping
  325.       program. I can supply several when you register. See the
  326.       "registration" section of this document for details.
  327.  
  328.  
  329.     -P
  330.  
  331.       Program will pause before printing each page. Hit any key to
  332.       print a page. This option is useful if you are feeding single
  333.       sheets to the printer.
  334.  
  335.  
  336.     -N
  337.  
  338.       This will cause the filename and page number to be printed in
  339.       the lower left-hand corner of each sheet. To avoid confusion
  340.       when using the -S, -O and -E options the page numbering is not
  341.       reset for each document when multiple documents are specified
  342.       on the command line(registered version only).
  343.  
  344.  
  345.     -D
  346.  
  347.       If you need to keep track of each source page, this option
  348.       will print a dashed line with a page number in the middle
  349.       whenever a form feed is encountered or after 66 lines of data.
  350.       Experience has shown that this option will be rarely used
  351.       because most documents either number their own pages or it is
  352.       just not important to keep track of original page breaks.
  353.  
  354.  
  355.     -T
  356.  
  357.       Normally when lines longer than the specified column width are
  358.       encountered, 2col will wrap the data to the next line. If you
  359.       prefer to truncate or discard excess characters on a line, you
  360.       should invoke this option.
  361.  
  362.  
  363.  
  364.     -G
  365.  
  366.       Sends control codes to enable full IBM graphics set (ASCII
  367.       128-255). The graphics set includes line drawing characters
  368.       and foreign alphabets.
  369.  
  370.  
  371.  
  372.  
  373.     -Fx
  374.  
  375.       2col will insert x blank lines at the top of each page before
  376.       printing. The default is 0.
  377.  
  378.  
  379.     -Mx
  380.  
  381.       CAUTION: IMPROPER USE OF THIS OPTION WILL CAUSE YOUR PRINTER
  382.       TO PRINT PAST THE BOTTOM OF THE PAGE.
  383.  
  384.       This command sets the left margin x spaces from the edge of
  385.       the page. Default is 0. Use this option with caution! Most
  386.       standard width printers only have 160 print positions across
  387.       the page. If you insert spaces with a margin command, the
  388.       printer will wrap characters that go past the 160th print
  389.       position to the left side of the page, causing  extra lines
  390.       to be inserted. If you use a left margin of 5, for example,
  391.       you might have to set the column width to -W77 to prevent
  392.       wraparound (this is only necessary if printable characters
  393.       would be pushed past the 160th column- blanks don't matter).
  394.  
  395.       The easiest way to achieve a left margin without having to
  396.       worry about characters wrapping is to use the Automargin
  397.       option (-Ux) described below.
  398.  
  399.       Given the limitations of standard width printers, it is
  400.       suggested that you permanently shift your paper several spaces
  401.       to the left. You can adjust your word processor margin
  402.       settings to compensate, so that normal printing will be
  403.       unaffected.
  404.  
  405.  
  406.     -K
  407.  
  408.       Including this option on the command line allows any
  409.       registered option listed below to be used, but only for a
  410.       one page demo. This option allows you to explore the
  411.       options available to registered users.
  412.  
  413.  
  414.     -?
  415.  
  416.       Instructs 2COL to ask for files to print once it is running.
  417.       You can specify files both on the command line and when 2COL
  418.       asks for filenames. Separate the file names with spaces. This
  419.       option is useful when 2COL is run from a menu or a Windows
  420.       icon.
  421.  
  422.  
  423.     -Q
  424.  
  425.       Adjusts line spacing for 24-pin printers. If you have a 24-pin
  426.       printer and do not use this option, pages will print too long.
  427.  
  428.  
  429.  
  430.       ***Options below are only in the registered version of 2col***
  431.  
  432.  
  433.  
  434.     -Yx
  435.  
  436.       The -Y option allows you to modify 2COL's default settings.
  437.       This MUST always be the first option on the command line
  438.       whenever you use it.
  439.  
  440.       Typing "2COL -Y1 <enter>" will cause 2COL to display all
  441.       current default settings.
  442.  
  443.       Typing "2COL -Y2 [options....] <enter>" will cause 2COL to
  444.       permanently remember those options by modifying the 2COL.EXE
  445.       program itself. Your personal registration code MUST always be
  446.       one of the options specified whenever you modify the default
  447.       settings. Whenever the -Y2 option is used, any options not
  448.       specified on the command line will be reset to the standard
  449.       defaults. Therefore, even if you change only one of your
  450.       custom options, you must reenter them all at the same time.
  451.       The next time you run 2COL the options you specified will
  452.       automatically be used.
  453.  
  454.       For example, if you want to set the number of lines/page to
  455.       102 and print the page numbers at the bottom, you would type:
  456.       2COL -Y2 -L102 -N registration code# <enter>. The next time
  457.       you type 2COL [filename] <enter> It would be as though you had
  458.       typed: 2COL -L102 -N registration code [filename].
  459.  
  460.       If there are several different option profiles you wish to
  461.       use, you can create different copies of 2COL.EXE with
  462.       different names, such as 2COL1.EXE, 2COL2.EXE, etc. The -Y2
  463.       option only modifies the EXE file having the same name and
  464.       path that you type on the command line.
  465.  
  466.       All defaults with an 'x' value can be temporarily overridden
  467.       with a different value on the commmand line. Any option
  468.       without an 'x' value can be activated from the command line.
  469.       To temporarily deactivate an option set as a permanent
  470.       default, type a minus after the option. For example, to
  471.       temporarily deactivate the N option, you would put -N- on the
  472.       command line: 2COL -N- [filename]
  473.  
  474.       THIS FUNCTION WILL NOT WORK ON .EXE FILES THAT HAVE BEEN
  475.       COMPRESSED WITH PKLITE. You must first decompress, use the -Y2
  476.       option and then recompress.
  477.  
  478.  
  479.     -A
  480.  
  481.       When multiple files are specified on the command line
  482.       (registered version only) you have the option of either
  483.       starting a new page for each file (default) or appending them
  484.       as though they were one continuous file. The -A option causes
  485.       them to be appended.
  486.  
  487.  
  488.     -Ux
  489.  
  490.       The aUtomargin function allows you to obtain as much margin as
  491.       possible according to the format of the document. 2col scans
  492.       the entire document before printing and adjusts the column
  493.       width to gain as much space on the print line as possible.
  494.       The space obtained is allocated to the left margin until the x
  495.       value you entered is reached. The remaining space, if any, is
  496.       then added to the right margin.
  497.  
  498.       If you have specified the -E option (to print on the reverse
  499.       side of the page), the first available space is used to create
  500.       a right margin (for binding) rather than a left margin.
  501.  
  502.  
  503.     -Zfilename
  504.  
  505.       Allows output to be routed to a file instead of to the
  506.       printer. The file can then be printed in background while
  507.       running other programs. For example, to send output to a file
  508.       called PRINT.TXT, you should include -ZPRINT.TXT on the
  509.       command line.If PRINT.TXT does not exist, it will be created.
  510.       If PRINT.TXT already exists, 2col output will be appended to
  511.       the end of the file. This command is only active in the
  512.       registered version of 2col. This option can also be used to
  513.       redirect output to LPT2, COM1, COM2, etc.
  514.  
  515.  
  516.    -Xx
  517.  
  518.       Prints exactly x pages in each column preserving original page
  519.       breaks and not suppressing consecutive blank lines. Thus the
  520.       original page formatting is maintained. Allowed range of x
  521.       is 1-3.
  522.                          -X option page formats:
  523.  
  524.              x=1                  x=2               x=3
  525.  
  526.            111 222              111 333           111 444
  527.            111 222              111 333           111 444
  528.            111 222              111 333
  529.            111 222                                222 555
  530.            111 222                                222 555
  531.            111 222              222 444
  532.            111 222              222 444           333 666
  533.            111 222              222 444           333 666
  534.  
  535.  
  536.  
  537. Examples:
  538.  
  539. 2COL 2COL.DOC -L102 <enter>  will print 102 lines/column
  540.  
  541. 2COL 2COL.DOC -L102 -N will print 102 lines/column and number pages.
  542.  
  543. 2COL 2COL.DOC -G -N  will number pages and enable IBM graphics set.
  544.  
  545.  
  546.  
  547.  
  548. Using 2COL with a word processor
  549.  
  550.     2COL will not work with most word processor documents in their
  551.     original form; but most word processors have what is called an
  552.     ASCII output or DOS output mode which 2COL will work with.
  553.  
  554.     For example, with WordPerfect, you can create a 2COL usable
  555.     file with the sequence: Control-F5,1,Save.
  556.  
  557.  
  558.  
  559. Distribution
  560.  
  561.     Permission is hereby given to copy and distribute this program
  562.     as long as no fee other than a minimal ( <$10 ) handling cost is
  563.     charged. It must be made clear to the buyer that this is only a
  564.     handling charge and not a registration fee.Please include all
  565.     files in their original unmodified form when distributing this
  566.     program. Permission to distribute may be revoked by the author
  567.     at any time for any reason.
  568.  
  569.     YOU MUST NOT DISTRIBUTE ANY COPY WHICH HAS BEEN BRANDED WITH
  570.     A REGISTRATION CODE. A program can be unbranded by typing
  571.     2COL -Y2 <enter>.
  572.  
  573.  
  574.  
  575.                                                      -Tony Caine-
  576.  
  577. GEnie mail:A.CAINE
  578.